home *** CD-ROM | disk | FTP | other *** search
/ Especial Multimedia / Especial Multimedia.iso / Multimed / Herra / TIMWIN.ZIP / README.TXT < prev    next >
Text File  |  1993-09-22  |  11KB  |  249 lines
  1.                      TIM FOR WINDOWS DEMO PROGRAM
  2.                        Installation directives
  3.  
  4. TIM for Windows is a program for scientific image processing. It operates
  5. on images from the real-world, in order to get data out of them. Images
  6. can be aquired using a video camera and a frame grabber, or imported
  7. as a TIFF file.
  8.  
  9. TIMWIN has a large set of operations and functions, including:
  10.  
  11. * image processing: pixel operations, linear and non-linear filters,
  12.   bitplane- and morphologic operations, 2D-FFT, graphics
  13. * operations for measurement and control
  14. * a full language for writing scripts and analyzing results
  15.   (including compiler,  editor & debugger)
  16. * an extended on line help
  17.  
  18. You can issue commands using menus, but for experienced users a
  19. command line interface is available with history, command line
  20. editing, etc.
  21.  
  22. TIMWIN runs on a PC-AT with:
  23. * Microsoft Windows 3.1 in standard or enhanced mode
  24. * At least 2, but preferably 4 MB of memory
  25. * A VGA display (super VGA, 256 colours recommended for image
  26.   display)
  27. * 2.5 MB of free disk space
  28. * A frame grabber is optional. With no frame grabber, the necessary 
  29.   image storage is created in standard memory, which will increase 
  30.   the memory requirements.
  31.   Supported frame grabbers:
  32.   Imaging Technology Inc.: PCVision, PCVisionPlus, VFG
  33.   Imagenation Corp.:       Cortex-I 
  34.  
  35. The TIMWIN-Demo program is a limited version of the full program:
  36.  
  37. * only 256x256 image processing is supported
  38. * the compiler is disabled, so you cannot execute self-made command
  39.   file programs
  40. * writing images to disk is disabled
  41.  
  42. The TIMWIN-Demo program is distributed on floppy disk and by anonymous
  43. ftp from several sites.
  44.  
  45. Conditions
  46. ~~~~~~~~~~
  47. This software is intended to give the image processing community an
  48. impression of the possibilities of TIM for Windows.
  49. You may use, copy and distribute this software freely.
  50. You may not:
  51. - modify the software,
  52. - remove the above described limitations,
  53. - sell the software.
  54.  
  55. TIM and TIMWIN are registered trade marks.
  56. DIFA and TEA cannot be held responsible or liable for any damages that
  57. might result of the use of TIMWIN Demo.
  58. Using TIMWIN Demo implies acceptance of these conditions.
  59.  
  60. Installation from zipped files
  61. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  62. The TIMWIN-Demo files are packed in a compressed file: timwin.zip
  63. To install TIMWIN demo from this file, follow the instructions below.
  64.  
  65. * Unpack the file TIMWIN.ZIP (use an unzipper that is compatible
  66.   with version 2.04, e.g. the newest version of PKUNZIP).
  67.   You can do this in a temporary directory, but you can also do it
  68.   in the intended TIMWIN directory, e.g. c:\timwin.  
  69.  
  70.   **** The feature described below may be not present in some versions ****
  71.   If, during installation, a file is copied to another directory,
  72.   the original is removed, to avoid occupying unnecessary
  73.   disk space. The free disk space calculator in the install program
  74.   doesn't take this into account, which may result in an warning
  75.   about insufficient disk space. In this case, it is safe to ignore this warning.
  76.  
  77.   If you need to repeat the installation, some files may have been removed.
  78.   In this case, repeat the unzip procedure.
  79.   **** end 
  80.  
  81. Further see the instructions for 'Installation from floppy disk',
  82. except that you specify the install program without argument,
  83. but with a path ('c:\timwin\install')
  84.  
  85. Installation from floppy disk
  86. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  87. To install TIMWIN-Demo from floppy disks, insert disk 1 and run
  88. install a: or  install b: from the Windows program manager (not from
  89. the MS-DOS prompt):
  90.  
  91. * In the program manager window, select File and then Run.
  92. * Enter 'install a:'  or  'install b:'
  93. * Answer the questions and installation takes place automatically.
  94.  
  95. If, after installation, TIMWIN complains about memory, replace the file
  96. IMAGES.TIM by IMGMIN.XXX, where XXX symbolises the frame grabber you are
  97. using (e.g. 'copy imgmin.nof images.tim' if you have no frame grabber)
  98.  
  99. INTROD.WRI       An introduction document.
  100. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  101. After successful installation, you are advised to open and study the text 
  102. in INTROD.WRI. This will give you a compact introduction in TIMWIN's
  103. concepts and usage. 
  104.  
  105. Running TIMWIN
  106. ~~~~~~~~~~~~~~
  107. Each time you invoke TIMWIN, a small command file (*inidemo) runs
  108. which initialises the system. It also brings up a help page, which
  109. will give some startup information and allows you to browse through
  110. the on-line manual to inform yourself about TIMWIN. This may take
  111. some time.
  112. After you clicked OK in the message box, the help page disappears
  113. and TIMWIN is ready to use. First follow the instructions in
  114. 'Setting up the system'
  115.  
  116. If you don't have a frame grabber, images must be displayed in a window.
  117. There are two options for displaying images on the computer screen; each
  118. of them is selected by choosing a specific image definition file ('images.xxx').
  119. If you have a high resolution monitor (at least 800x600 @ 256 colours), use
  120. the setup defined in 'images.pqr' (this is the default setup). If you have 
  121. a standard VGA adapter or less than 256 colours (16), use the setup
  122. defined in 'images.nof'. 
  123. To change the setup, copy the appropriate file into
  124. the TIMWIN directory under the name: 'images.tim'.
  125.  
  126. Specifying images processing commands can be done using dialog
  127. boxes (from the menu bar in the top of the main window) or using the
  128. command line (in the bottom of the main window). It is advised to
  129. first familiarise yourself with TIMWIN's concepts by browsing through
  130. the on line help (select Help on the main menu or press any other help
  131. button to start help).
  132.  
  133. To see some image processing programs running, enter the command
  134.  
  135.    *demo1
  136.  
  137. in the command line. This will start a set of pre-compiled programs,
  138. which will give you a good impression of TIMWIN's capabilities.
  139. Realise, that the demo's are the most informative on systems having a
  140. frame grabber, because then the process can be followed from image to
  141. image. If there is no frame grabber, the setup as specified in 'images.pqr' 
  142. will give you a 'next best' view. On standard VGA systems, the setup as 
  143. specified in 'images.nof' will give a satisfying view of what takes place,
  144. although some intermediate steps will be skipped.
  145.  
  146. If desired, you can run the demo program in single step mode
  147. by starting it as follows:
  148.  
  149.    *demo1 debug
  150.  
  151. To change execution mode of a running program to debug mode, press the
  152. ESC key. Then choose the desired running mode.
  153.  
  154. Setting up the system
  155. ~~~~~~~~~~~~~~~~~~~~~
  156. First go to the Contr. menu and select Installation. Press the
  157. File Paths button and fill in absolute paths for the command file
  158. and image directories (e.g. 'c:\timwin\cmc').
  159. If there is a frame grabber in your system, after the installation you
  160. must go to Installation in the Contr menu, to adapt TIMWIN to the
  161. settings of your frame grabber.
  162. Also, if you use a memory mapped device like a frame grabber under
  163. Windows, be sure to have a line like 'EMMExclude=D000-DFFF' in your Windows'
  164. System.ini file (in the [386Enh] section. The values must conform the
  165. frame grabber's memory base adress). The install program does this for you,
  166. but if you have another memory mapped card in your system (e.g. a network 
  167. adapter), it is advised to check (and modify) the setting manually.
  168. The same holds for the Emm386 driver that may be in your Config.sys
  169. file. See your DOS manual for details.
  170.  
  171. Feedback
  172. ~~~~~~~~
  173. We would like to have feedback from people who have been experimenting with
  174. TIMWIN. Please tell us your experiences, either positive or negative.
  175. If you have any questions or suggestions about TIMWIN, please contact:
  176.  
  177. For commercial information:        For technical information
  178. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~    ~~~~~~~~~~~~~~~~~~~~~~~~~
  179. DIFA bv., Image Processing Dpt.    Robert J.Ekkers
  180. POBox 3132                         Fax no. (31)15 - 626740
  181. 4800 DC  Breda                     EMail: ekkers@ph.tn.tudelft.nl
  182. the Netherlands
  183. Fax no. (31)76 - 711953
  184.  
  185.  
  186. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  187. Appendix:
  188. After installation, the following files should be in the respective
  189. directories:
  190.  
  191. In the TIMWIN directory:
  192.  TIMWIN.EXE       The TIMWIN main program
  193.  EDITCF.EXE       TIMWIN's editor (can also be used for other purposes)
  194.  
  195.  TIMDLL.DLL       The image processing DLL. It is copied from one of the
  196.                   following files, depending on your frame grabber:
  197.                    TIMPCVIS.DLL
  198.                    TIMFGPLU.DLL
  199.                    TIMPCVIS.DLL
  200.                    TIMVFG.DLL
  201.                    TIMCORTE.DLL
  202.  
  203.  COMPDLL.DLL      The compiler DLL. Although compiling is disabled in the
  204.                   DEMO version, this DLL is needed to solve references for
  205.                   the other modules,
  206.  
  207.  TIMEXQ.DLL       The executer DLL. It executes command files
  208.  
  209.  IMAGES.TIM       The image definition file. It is copied from one of the
  210.                   following files, depending on your frame grabber:
  211.                    IMAGES.CX1    Cortex-I
  212.                    IMAGES.FGD    PCVisionPlus (dual frame mode)
  213.                    IMAGES.FGS    PCVisionPlus (single frame mode)
  214.                    IMAGES.PCV    PCVision
  215.                    IMAGES.VFG    VFG and other series 100 frame grabbers
  216.                    IMAGES.NOF    No frame grabber, 2 windows images: 'h' and 'i'.
  217.                    IMAGES.PQR    No frame grabber, 4 windows images: p, q, r and s
  218.                                  Since, in the demo program, pocessing takes place in
  219.                                  these images, this setup allows you to follow each 
  220.                                  step in detail.         
  221.  
  222. The following files can be used if memory usage of 
  223. the above files is too high:
  224.                    IMGMIN.CX1
  225.                    IMGMIN.FGD
  226.                    IMGMIN.FGS
  227.                    IMGMIN.PCV
  228.                    IMGMIN.VFG
  229.                    IMGMIN.NOF
  230.  
  231.  STANDARD.FNT     Various text fonts for writing text in images
  232.  CHIC09.FNT       (See the 'text' and 'lcset' commands)
  233.  COUR11.FNT       The number indicates the point size.
  234.  MONA09.FNT
  235.  TIME15.FNT
  236.  TIME15P.FNT
  237.  UPPER.FNT
  238.  
  239.  ALIAS.TIM        Alias definitions
  240.  ERMSGS.TIM       Error message texts
  241.  
  242.  
  243. In the CMC directory:
  244.  *.CMD            Sources of the DEMO command files
  245.  *.CMC            Compiled DEMO command files
  246.  
  247. In the IM directory:
  248.  *.IM and *.TIF   Image files
  249.